home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / mq_getattr.z / mq_getattr
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmqqqq____ggggeeeettttaaaattttttttrrrr((((3333cccc))))                                                  mmmmqqqq____ggggeeeettttaaaattttttttrrrr((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr - get attributes of a message queue
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_mmmm_qqqq_uuuu_eeee_uuuu_eeee_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr _((((_mmmm_qqqq_dddd______tttt _m_q_d_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_qqqq______aaaa_tttt_tttt_rrrr _****_m_q_s_t_a_t_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr saves the attributes and status information of the message
  18.      queue named by _m_q_d into the _m_q__a_t_t_r structure at address _m_q_s_t_a_t.  The
  19.      following fields of the _m_q__a_t_t_r structure are updated after a successful
  20.      call to _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr:
  21.  
  22.         _llll_oooo_nnnn_gggg _mmmm_qqqq______ffff_llll_aaaa_gggg_ssss_;;;;        _////_**** _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee _qqqq_uuuu_eeee_uuuu_eeee _ffff_llll_aaaa_gggg_ssss _****_////
  23.         _llll_oooo_nnnn_gggg _mmmm_qqqq______mmmm_aaaa_xxxx_mmmm_ssss_gggg_;;;;       _////_**** _mmmm_aaaa_xxxx_iiii_mmmm_uuuu_mmmm _nnnn_uuuu_mmmm_bbbb_eeee_rrrr _oooo_ffff _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee_ssss _****_////
  24.         _llll_oooo_nnnn_gggg _mmmm_qqqq______mmmm_ssss_gggg_ssss_iiii_zzzz_eeee_;;;;      _////_**** _mmmm_aaaa_xxxx_iiii_mmmm_uuuu_mmmm _ssss_iiii_zzzz_eeee _oooo_ffff _aaaa _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee_****_////
  25.         _llll_oooo_nnnn_gggg _mmmm_qqqq______cccc_uuuu_rrrr_mmmm_ssss_gggg_ssss_;;;;      _////_**** _nnnn_uuuu_mmmm_bbbb_eeee_rrrr _oooo_ffff _mmmm_eeee_ssss_ssss_aaaa_gggg_eeee_ssss _cccc_uuuu_rrrr_rrrr_eeee_nnnn_tttt_llll_yyyy _oooo_nnnn _qqqq_uuuu_eeee_uuuu_eeee _****_////
  26.  
  27.      The fields have the following meanings:
  28.  
  29.      _mmmm_qqqq______ffff_llll_aaaa_gggg_ssss  The set of flags which may be applied to the message queue on a
  30.                queue descriptor _m_q_d basis, rather than to the queue itself.
  31.                The following flags are supported:
  32.  
  33.                _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK If set, _mmmm_qqqq______ssss_eeee_nnnn_dddd and _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee operations on the
  34.                queue named by _m_q_d will not block when the queue is full or
  35.                empty, respectively.
  36.  
  37.      _mmmm_qqqq______mmmm_aaaa_xxxx_mmmm_ssss_gggg The maximum number of messages that can be queued at any one
  38.                time.  _mmmm_qqqq______ssss_eeee_nnnn_dddd will fail, if O_NONBLOCK flag is set, or block
  39.                after this many messages are queued. This attribute of the
  40.                queue can be set only at time of queue creation.
  41.  
  42.      _mmmm_qqqq______mmmm_ssss_gggg_ssss_iiii_zzzz_eeee
  43.                The maximum size of a message that can be sent to or received
  44.                from the queue.  This attribute of the queue can be set only at
  45.                the time of queue creation.
  46.  
  47.      _mmmm_qqqq______cccc_uuuu_rrrr_mmmm_ssss_gggg_ssss
  48.                The number of messages currently on the message queue. This
  49.                attribute can only be queried and cannot be explicitly set.
  50.  
  51.      _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr will fail if one or more of the following conditions are true:
  52.  
  53.      [EBADF]        The message queue descriptor, _m_q_d, is not valid.
  54.  
  55.      [EINTR]        A signal interrupted the _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr function call.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmqqqq____ggggeeeettttaaaattttttttrrrr((((3333cccc))))                                                  mmmmqqqq____ggggeeeettttaaaattttttttrrrr((((3333cccc))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c), _iiii_nnnn_tttt_rrrr_oooo(3c), _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk(3c), _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee(3c), _mmmm_qqqq______ssss_eeee_nnnn_dddd(3c),
  76.      _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr(3c), _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c)
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      Upon successful completion, a value of 0 is returned and the attributes
  80.      of the queue are written into the _m_q__a_t_t_r structure pointed to by _m_q_s_t_a_t.
  81.      Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the
  82.      error.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.